iphoneUseDeviceResolution
Type
command
Summary
Sets whether the full resolution of high-resolution devices is to be used
Syntax
iphoneUseDeviceResolution <coordsInPixels> [, <customCtrlsInPixels>]
Description
Use the iphoneUseDeviceResolution command to specify whether the full resolution of high-resolution devices should be used.
The iphoneUseDeviceResolution command specifies whether the full resolution of high-resolution devices should be used.
The iPhone 4 has a display with double the resolution in both horizontal and vertical directions. By default, iOS handles this by mapping one logical 'point' to two physical 'pixels' with applications (LiveCode included) interpreting everything in terms of logical points. This means that apps targetted for older devices can run identically on the newer iPhone 4 devices.
If the iphoneUseDeviceResolution command is passed true as the first argument, LiveCode ensures that co-ordinates and sizes specified in LiveCode are treated as being in pixels, rather than logical points. In particular, when changed, a resizeStack message is sent notifying the size change of the current main-stack, and functions and properties (such as the screenRect) reflects co-ordinates in pixels.
If the iphoneUseDeviceResolution command is passed true as the second argument, LiveCode ensures that co-ordinates and sizes specified in LiveCode for custom controls are treated as being in pixels, rather than logical points.
The notion of pixel and logical point remains valid on older devices, it is just that it is always 1-1 thus using this command has no effect there. The scale of the device's screen (relative to a non-Retina display) can be queried using iphoneDeviceScale(). This function returns 2 if the display is a Retina display, or 1 otherwise.
Parameters
| Name | Type | Description |
|---|---|---|
coordsInPixels | bool | When |
customCtrlsInPixels | bool | When |
Examples
-- All co-ordinates and sizes treated as pixels
iphoneUseDeviceResolution true
-- All co-ordinates and sizes treated as pixels
iphoneUseDeviceResolution true, true
-- Co-ordinates and sizes for custom controls are treated
-- as logical points
iphoneUseDeviceResolution true, false
-- All co-ordinates and sizes treated as logical points
iphoneUseDeviceResolution false
Related
function: iphoneDeviceScale
message: resizeStack
property: scaleFactor, pixelScale, screenPixelScale, screenPixelScales, systemPixelScale
Compatibility and Support
Introduced
LiveCode 4.5.2
OS
ios
Platforms
mobile